---
description: Managing custom domains on Hasura Cloud
title: 'Cloud: Custom Project Domains'
keywords:
  - hasura
  - docs
  - project
  - domains
sidebar_position: 32
sidebar_label: Custom domains
---

import Thumbnail from '@site/src/components/Thumbnail';
import HeadingIcon from '@site/src/components/HeadingIcon';
import ProductBadge from '@site/src/components/ProductBadge';

# Custom Domains

<ProductBadge pro ee />

## Introduction

In the `Domains` tab of your Project, you can see the default Hasura domain, and you have the possibility to add custom
domains.

## Adding a custom domain

You can add a custom domain to your Hasura Cloud project by following the steps below.

### Step 1: Navigate to add a custom domain

On the `Domains` tab, click on the `New Custom Domain` button.

<Thumbnail src="/img/projects/add-custom-domain.png" alt="Add custom domain" width="727px" />

### Step 2: Add your custom domain

Enter your custom domain and click the `Add` button.

<Thumbnail src="/img/projects/choose-custom-domain.png" alt="Choose custom domain" width="727px" />

### Step 3: Add the record to your DNS

After adding a custom domain, the following window will show up:

<Thumbnail src="/img/projects/dns-settings.png" alt="DNS settings" width="727px" />

Add the default Hasura domain as a `CNAME` record to your DNS.

:::info Note

If you're using [Cloudflare](https://www.cloudflare.com) as your DNS provider, do not enable the proxy (orange cloud)
until the certificate is generated. i.e. `Proxy status` should be `DNS only`. You can enable the proxy after SSL
certificate is generated.

:::

Until this is done, the dashboard will show a notice that the DNS validation is pending.

<Thumbnail src="/img/projects/dns-validation-pending.png" alt="DNS validation pending" width="727px" />

:::info Note

Depending on your DNS provider, it might take up to 24 hours for the DNS record to be added.

:::

## DNS validated

Once the DNS is validated, the dashboard will update the status with the following notice:

<Thumbnail src="/img/projects/dns-validated.png" alt="DNS validated" width="727px" />
